home *** CD-ROM | disk | FTP | other *** search
/ Tech Arsenal 1 / Tech Arsenal (Arsenal Computer).ISO / tek-04 / hbb10.zip / HBB.TXT < prev    next >
Text File  |  1991-09-30  |  38KB  |  1,453 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.             
  8.             
  9.             
  10.             
  11.             
  12.             
  13.             
  14.             
  15.             
  16.             
  17.             
  18.             
  19.             
  20.             
  21.             
  22.             
  23.             
  24.             
  25.             
  26.                                Hybrid Btrieve Browser
  27.             
  28.             
  29.             
  30.                                    Version 1.00
  31.             
  32.                                Copyright (c) 1991 by
  33.             
  34.                                  Michael S. Graham
  35.             
  36.                                 All rights reserved
  37.             
  38.             
  39.             
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.             
  74.             WARRANTY
  75.             
  76.             
  77.             This software is provided as-is.  There are no warranties,
  78.             expressed or implied.
  79.             
  80.             MICHAEL S. GRAHAM DISCLAIMS ALL WARRANTIES RELATING TO THIS
  81.             SOFTWARE, WHETHER EXPRESS OR IMPLIED, INCLUDING BUT NOT
  82.             LIMITED TO ANY IMPLIED WARRANTIES OF MERCHANTABILITY AND
  83.             FITNESS FOR A PARTICULAR PURPOSE, AND ALL SUCH WARRANTIES
  84.             ARE EXPRESSLY AND SPECIFICALLY DISCLAIMED. NEITHER
  85.             MICHAEL S. GRAHAM NOR ANYONE ELSE WHO HAS BEEN INVOLVED IN
  86.             THE CREATION, PRODUCTION, OR DELIVERY OF THIS SOFTWARE SHALL
  87.             BE LIABLE FOR ANY INDIRECT, CONSEQUENTIAL, OR INCIDENTAL
  88.             DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE SUCH
  89.             SOFTWARE EVEN IF MICHAEL S. GRAHAM HAS BEEN ADVISED OF THE
  90.             POSSIBILITY OF SUCH DAMAGES OR CLAIMS. IN NO EVENT SHALL
  91.             MICHAEL S. GRAHAM's LIABILITY FOR ANY DAMAGES EVER EXCEED
  92.             THE PRICE PAID FOR THE LICENSE TO USE THE SOFTWARE,
  93.             REGARDLESS OF THE FORM OF CLAIM. THE PERSON USING THE
  94.             SOFTWARE BEARS ALL RISK AS TO THE QUALITY AND PERFORMANCE OF
  95.             THE SOFTWARE.  Some states do not allow the exclusion of the
  96.             limit of liability for consequential or incidental damages,
  97.             so the above limitation may not apply to you.
  98.             
  99.             
  100.             This agreement shall be governed by the laws of the State of
  101.             New Jersey and shall inure to the benefit of Michael
  102.             S.Graham and any successors, administrators, heirs and
  103.             assigns. Any action or proceeding brought by either party
  104.             against the other arising out of or related to this
  105.             agreement shall be brought only in a STATE or FEDERAL COURT
  106.             of competent jurisdiction located in Morris County, New
  107.             Jersey. The parties hereby consent to in personam
  108.             jurisdiction of said courts."
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.             
  140.                              HYBRID BTRIEVE BROWSER
  141.             
  142.             
  143.                          USER'S MANUAL TABLE OF CONTENTS
  144.             
  145.             
  146.             Shareware .........................................  page 1
  147.             
  148.             Introduction ......................................  page 2
  149.             
  150.             System Requirements ...............................  page 3
  151.             
  152.             Installation ......................................  page 3
  153.             
  154.             Files Included ....................................  page 3
  155.             
  156.             Patching Btrieve ..................................  page 4
  157.             
  158.             The description file ..............................  page 6
  159.             
  160.             Changing the demo description file ................  page 8
  161.             
  162.             Demo description file (HBB.DSC) ...................  page 9
  163.             
  164.             Demo data file layout (HBB.DAT) .. ................  page 11
  165.             
  166.             Demo data Btrieve description file ................  page 12
  167.             
  168.             Running the Hybrid Btrieve Browser program ........  page 13
  169.             
  170.             Command line switches .............................  page 15
  171.             
  172.             Future versions ...................................  page 16
  173.             
  174.             Error messages ....................................  page 18
  175.             
  176.             Trademarks and Acknowledgements ...................  page 19
  177.             
  178.             
  179.             
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.             
  206.             SHAREWARE
  207.             
  208.             
  209.             This software is provided as Shareware. This means you have
  210.             the opportunity to try it before you buy it. If you continue
  211.             to use this software for more than 90 days you are requested
  212.             to become a registered user. Registered users will receive
  213.             an update to the most recent version of the software, one
  214.             free update, and free support.
  215.             
  216.             To register as a user of the HYBRID BTRIEVE BROWSER please
  217.             send $29.95 to the address below, plus $3.00 for shipping
  218.             and handling. ($5 for Canada and $8 for airmail outside
  219.             North America). If you are interested in a site license,
  220.             please call or write for pricing.
  221.             
  222.             The address is:
  223.             
  224.             Michael S. Graham
  225.             3 Algonquin Ave.
  226.             Rockaway, NJ 07866
  227.             
  228.             
  229.             If you have any questions about this product or about
  230.             registration, you can reach me on Compuserve. My number is
  231.             75140,3705. If you would like to talk to me, the number
  232.             where I can be reached is 201-625-4297. Please call between
  233.             6:00pm and 10:00pm EST, as I work during the day.
  234.             
  235.             
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.                                     Page 1
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.             
  272.             INTRODUCTION
  273.             
  274.             
  275.             The Hybrid Btrieve Browser is a TSR (Terminate and Stay
  276.             Resident) program. It will load into memory and then return
  277.             control to DOS until you enter the hot key combination of
  278.             ALT + LEFT SHIFT + R. The Hybrid Btrieve Browser will then
  279.             open the specified Btrieve file and display the fields setup
  280.             in the HBB.DSC description file.
  281.             
  282.             The description file contains all the information needed to
  283.             open and display up to 10 different file views, with each
  284.             view having up to 10 fields displayed at one time. You can
  285.             switch between views, scroll the view screen four ways (up,
  286.             down, left, right), search for a specified key, or paste one
  287.             of the view fields into the keyboard buffer, which can be
  288.             intercepted by the program that the browser was popped up
  289.             over.
  290.             
  291.             The Hybrid Btrieve browser currently takes up about 85K of
  292.             conventional memory.
  293.             
  294.             This program can be used to display name, address and
  295.             telephone information of frequently contacted people (ex.
  296.             customers, patients, vendors). It can be used to add quick
  297.             searching capabilities to existing programs. It can even be
  298.             used to display popup help information.
  299.             
  300.             
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.                                     Page 2
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.             
  338.             SYSTEM REQUIREMENTS
  339.             
  340.             
  341.             To run this software you will need an IBM PC, XT, AT  or
  342.             compatible with a minimum of 512K. DOS version 3.x or higher
  343.             and Btrieve version 4.10 or higher are required. The Hybrid
  344.             Btrieve Browser will only popup over text screens. It will
  345.             work with 43 and 50 line text modes. However, it will not
  346.             popup if you are in graphics mode.
  347.             
  348.             
  349.             
  350.             INSTALLATION
  351.             
  352.             
  353.             Installation of this software is very easy.  Copy all of the
  354.             files on this disk into the drive and directory in which the
  355.             browser will be run. Only three files are actually needed.
  356.             HBB.EXE (the browser program) , HBB.DSC (either the demo
  357.             description file provided on this disk or an HBB.DSC file
  358.             that you created), and a Btrieve file (either the demo data
  359.             file HBB.DAT or a data file that you specify in your HBB.DSC
  360.             file).
  361.             
  362.             
  363.             
  364.             FILES INCLUDED
  365.             
  366.             
  367.             HBB.TXT     - This document file
  368.             HBB.DSC     - Demo description file
  369.             HBB.DAT     - Demo data file
  370.             HBB.EXE     - Hybrid Btrieve Browser program
  371.             DEMO.BAT    - Batch that will load Btrieve and run HBB.EXE
  372.             BTRIEVE.EXE - Btrieve for DOS network version 5.10
  373.             README.1ST  - ASCII file indicating Btrieve was already
  374.                           patched to work with this TSR
  375.             
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.                                     Page 3
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.             
  404.             PATCHING BTRIEVE
  405.             
  406.             
  407.             If you elect to use your own copy of Btrieve, instead of the
  408.             one provided on this disk, you will need to patch the file
  409.             using debug. If you don't patch it, the program will freeze
  410.             on the first call Btrieve makes to DOS.
  411.             
  412.             Btrieve version 4.xx and 5.xx checks to make sure that DOS
  413.             is not in a critical state before calling DOS to do a
  414.             Btrieve operation. If the flag is set Btrieve will loop,
  415.             waiting until DOS is not in a critical state before
  416.             continuing. This looping will cause the system to hang. The
  417.             following debug patches to Btrieve will jump past this
  418.             checking and allow the Btrieve operation to be performed.
  419.             
  420.             
  421.             Version 4.xx
  422.             ------------
  423.             
  424.             Copy Btrieve.exe to Btrieve (Don't put an extension on the
  425.                                          destination file.)
  426.             
  427.             debug Btrieve
  428.             
  429.             -r  (check registers, find the value of CX (length of file),
  430.                  for example CX = a61c, then use this address in the
  431.                  next line)
  432.             
  433.             -s 0 a61c b8 00 34  (this will return 2 addresses)
  434.             
  435.             xxxx:QQQQ  (where QQQQ is used to reference address 1)
  436.             xxxx:RRRR  (where RRRR is used to reference address 2)
  437.             
  438.             -u QQQQ  (unassemble to look for first "pop es")
  439.             
  440.             -a QQQQ  (assemble)
  441.             
  442.             xxxx:QQQQ jmp AAAA:BBBB  (where AAAA:BBBB is the address
  443.                                       of the first "pop es")
  444.             
  445.             xxxx:QQQS (just hit enter)
  446.             
  447.             Do the same thing for address RRRR
  448.             
  449.             After changing QQQQ and RRRR
  450.             
  451.             -w  (save back)
  452.             
  453.             -q  (quit)
  454.             
  455.             Copy Btrieve to Btrieve.exe
  456.             
  457.  
  458.  
  459.  
  460.                                     Page 4
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.             
  470.             Version 5.xx
  471.             ------------
  472.             
  473.             Copy Btrieve.exe to Btrieve (Don't put an extension on the
  474.                                          destination file.)
  475.             
  476.             debug Btrieve
  477.             
  478.             -r  (check registers, find the value of CX (length of file),
  479.                  for example CX = a61c, then use this address in the
  480.                  next line)
  481.             
  482.             -s 0 a61c b8 00 34  (this will return 1 address)
  483.             
  484.             xxxx:QQQQ  (where QQQQ is used to reference address 1)
  485.             
  486.             -u QQQQ  (unassemble to look for first "pop es")
  487.             
  488.             -a QQQQ  (assemble)
  489.             
  490.             xxxx:QQQQ jmp AAAA:BBBB  (where AAAA:BBBB is the address
  491.                                       of the first "pop es")
  492.             
  493.             xxxx:QQQS (just hit enter)
  494.             
  495.             -w  (save back)
  496.             
  497.             -q  (quit)
  498.             
  499.             Copy Btrieve to Btrieve.exe
  500.             
  501.  
  502.  
  503.  
  504.  
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.                                     Page 5
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.             
  536.             THE DESCRIPTION FILE
  537.             
  538.             
  539.             The description file is the heart of the Hybrid Btrieve
  540.             Browser system. It contains all the information needed to
  541.             display up to 10 different views, with 10 fields per view.
  542.             
  543.             The HBB description file is a simple ASCII file. It is
  544.             similar to the description file used by Btrieve to define
  545.             the record length, page and index information for the
  546.             Btrieve file when it is created.
  547.             
  548.             The HBB program only looks at the data contained between
  549.             quotation marks. All other information is used to make the
  550.             description file more readable. Blank lines can be used to
  551.             separate groups like view information and field information.
  552.             Value names like "default view = " can be used to easily
  553.             identify what the value means.
  554.             
  555.             Below are examples of each value needed in a description
  556.             file. An explanation of what it is used for appears on the
  557.             right hand side..
  558.             
  559.             
  560.             default view = "2"               | Use view number 2 when  |
  561.                                              | HBB is started up.      |
  562.             
  563.             # of views = "3"                 | The total number of     |
  564.                                              | views is 3.             |
  565.             
  566.             view title = "Customer Address"  | View title which will be|
  567.                                              | displayed when you      |
  568.                                              | choose VIEW while in    |
  569.                                              | HBB.                    |
  570.             
  571.             view file name = "CUSTOMER.DAT"  | Btrieve file name to be |
  572.                                              | opened and displayed.   |
  573.             
  574.             view record length = "512"       | The fixed record length |
  575.                                              | of the Btrieve file.    |
  576.                                              | This should be the same |
  577.                                              | record length used when |
  578.                                              | the file was created.   |
  579.             
  580.             view index = "1"                 | The Btrieve index       |
  581.                                              | number.                 |
  582.             
  583.             view index type = "11"           | This number corresponds |
  584.                                              | to the Btrieve Extended |
  585.                                              | Key Type Codes 0-14.    |
  586.                                              | Currently only 0 and 11 |
  587.                                              | are supported. They are |
  588.                                              | string type and C string|
  589.  
  590.  
  591.  
  592.                                     Page 6
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.  
  601.                                              | type.                   |
  602.             
  603.             view paste field = "1"           | The field number between|
  604.                                              | 1-10 which will be      |
  605.                                              | pasted to the keyboard  |
  606.                                              | buffer if you choose the|
  607.                                              | paste option.           |
  608.             
  609.             view # of columns = "70"         | This is the width of the|
  610.                                              | browse record window.   |
  611.                                              | The minimum is 26. The  |
  612.                                              | maximum is 70.          |
  613.             
  614.             view # of rows = "10"            | This is the height of   |
  615.                                              | the browse record       |
  616.                                              | window. The minimum is  |
  617.                                              | 2. The maximum is 15.   |
  618.             
  619.             view # of fields = "7"           | The number of fields    |
  620.                                              | that will be displayed  |
  621.                                              | next to each other for  |
  622.                                              | each browse record. The |
  623.                                              | minimum is 1. The       |
  624.                                              | maximum is 10.          |
  625.             
  626.             field title = "Customer"         | This is the name of the |
  627.                                              | field that will display |
  628.                                              | above the value. If the |
  629.                                              | length of the field     |
  630.                                              | value is less than the  |
  631.                                              | length of the field,    |
  632.                                              | then the field title    |
  633.                                              | length will be truncated|
  634.                                              | to be equal to the value|
  635.                                              | length.                 |
  636.             
  637.             field position = "1"             | The starting position of|
  638.                                              | the field in the record.|
  639.                                              | This is similar to the  |
  640.                                              | Btrieve description file|
  641.                                              | position.               |
  642.             
  643.             field length = "10"              | Field length. Minimum   |
  644.                                              | length is 1. The maximum|
  645.                                              | length is 255.          |
  646.             
  647.             field type = "0"                 | This number corresponds |
  648.                                              | to the Btrieve Extended |
  649.                                              | Key Type Codes 0-14.    |
  650.                                              | Currently only 0 and 11 |
  651.                                              | are supported. They are |
  652.                                              | string type and C string|
  653.                                              | type.                   |
  654.             
  655.  
  656.  
  657.  
  658.                                     Page 7
  659.  
  660.  
  661.  
  662.  
  663.  
  664.  
  665.  
  666.  
  667.             
  668.             CHANGING THE DEMO DESCRIPTION FILE
  669.             
  670.             
  671.             Before you try creating you own HBB.DSC file, you might want
  672.             to try changing the demo HBB.DSC file.
  673.             
  674.             Below is a listing of the contents of the demo HBB.DSC
  675.             description file, the record layout of the demo HBB.DAT
  676.             Btrieve Data file, and the Btrieve description file that was
  677.             used to create the demo HBB.DAT file. This is included in
  678.             case you want to experiment with changing the indexes in the
  679.             demo description file.
  680.             
  681.             To run the Hybrid Btrieve Browser with the demo data and
  682.             description file you need to run Btrieve with a page size of
  683.             2048 (ex. BTRIEVE /P:2048).
  684.             
  685.             You might want to start off by changing some titles and
  686.             display field lengths. If you change a length, be sure not
  687.             to make it longer than the defined length in the data file.
  688.             
  689.             Next you can remove the "Attention" field from the first
  690.             view. Remember to change the "view # of fields = " from 7 to
  691.             6.
  692.             
  693.             Next, add the Btrieve data file "rep" field to the second
  694.             view. Be sure to increase the "view # of fields = " by 1.
  695.             
  696.             Finally, try adding a new view to the description file. This
  697.             view should contain account, name, contact1, rep, and misc.
  698.             Also, use index #1 (index by name), and make the paste field
  699.             the contact1 field.
  700.             
  701.  
  702.  
  703.  
  704.  
  705.  
  706.  
  707.  
  708.  
  709.  
  710.  
  711.  
  712.  
  713.  
  714.  
  715.  
  716.  
  717.  
  718.  
  719.  
  720.  
  721.  
  722.  
  723.  
  724.                                     Page 8
  725.  
  726.  
  727.  
  728.  
  729.  
  730.  
  731.  
  732.  
  733.             
  734.             DEMO DESCRIPTION FILE (HBB.DSC)
  735.             
  736.             
  737.             default view = "2"
  738.             # of views = "2"
  739.             
  740.             view title = "Doctor Address"
  741.             view file name = "HBB.DAT"
  742.             view record length = "512"
  743.             view index = "1"
  744.             view index type = "11"
  745.             view paste field = "1"
  746.             view # of columns = "70"
  747.             view # of rows = "10"
  748.             view # of fields = "7"
  749.             
  750.             field title = "Account #"
  751.             field position = "1"
  752.             field length = "10"
  753.             field type = "11"
  754.             
  755.             field title = "Doctor Name"
  756.             field position = "12"
  757.             field length = "40"
  758.             field type = "11"
  759.             
  760.             field title = "Address"
  761.             field position = "53"
  762.             field length = "40"
  763.             field type = "11"
  764.             
  765.             field title = "City"
  766.             field position = "94"
  767.             field length = "20"
  768.             field type = "11"
  769.             
  770.             field title = "State"
  771.             field position = "115"
  772.             field length = "2"
  773.             field type = "11"
  774.             
  775.             field title = "Zip"
  776.             field position = "118"
  777.             field length = "10"
  778.             field type = "11"
  779.             
  780.             field title = "Attention"
  781.             field position = "233"
  782.             field length = "40"
  783.             field type = "11"
  784.             
  785.             view title = "Doctor Phone List"
  786.             view file name = "HBB.DAT"
  787.  
  788.  
  789.  
  790.                                     Page 9
  791.  
  792.  
  793.  
  794.  
  795.  
  796.  
  797.  
  798.  
  799.             view record length = "512"
  800.             view index = "0"
  801.             view index type = "11"
  802.             view paste field = "2"
  803.             view # of columns = "70"
  804.             view # of rows = "8"
  805.             view # of fields = "6"
  806.             
  807.             field title = "Account #"
  808.             field position = "1"
  809.             field length = "10"
  810.             field type = "11"
  811.             
  812.             field title = "Doctor Name"
  813.             field position = "12"
  814.             field length = "22"
  815.             field type = "11"
  816.             
  817.             field title = "Contact"
  818.             field position = "233"
  819.             field length = "15"
  820.             field type = "11"
  821.             
  822.             field title = "Phone"
  823.             field position = "129"
  824.             field length = "10"
  825.             field type = "11"
  826.             
  827.             field title = "Fax"
  828.             field position = "150"
  829.             field length = "10"
  830.             field type = "11"
  831.             
  832.             field title = "Modem"
  833.             field position = "171"
  834.             field length = "10"
  835.             field type = "11"
  836.             
  837.  
  838.  
  839.  
  840.  
  841.  
  842.  
  843.  
  844.  
  845.  
  846.  
  847.  
  848.  
  849.  
  850.  
  851.  
  852.  
  853.  
  854.  
  855.  
  856.                                     Page 10
  857.  
  858.  
  859.  
  860.  
  861.  
  862.  
  863.  
  864.  
  865.             
  866.             DEMO DATA FILE LAYOUT (HBB.DAT)
  867.             
  868.             
  869.             // Define the doctor record layout.
  870.             typedef struct
  871.             {
  872.                  char account[11];
  873.                  char name[41];
  874.                  char address[41];
  875.                  char city[21];
  876.                  char state[3];
  877.                  char zip[11];
  878.                  char phone[21];
  879.                  char fax[21];
  880.                  char modem[21];
  881.                  char principal[41];
  882.                  char contact1[41];
  883.                  char contact2[41];
  884.                  char group[11];
  885.                  char rep[11];
  886.                  char support[11];
  887.                  char dealer[11];
  888.                  char misc[21];
  889.                  char filler[132]; // 511 bytes
  890.                  char text[16001]; // 16512 bytes
  891.             } DOCTOR_FILE_RECORD;
  892.             
  893.  
  894.  
  895.  
  896.  
  897.  
  898.  
  899.  
  900.  
  901.  
  902.  
  903.  
  904.  
  905.  
  906.  
  907.  
  908.  
  909.  
  910.  
  911.  
  912.  
  913.  
  914.  
  915.  
  916.  
  917.  
  918.  
  919.  
  920.  
  921.  
  922.                                     Page 11
  923.  
  924.  
  925.  
  926.  
  927.  
  928.  
  929.  
  930.  
  931.             
  932.             DEMO DATA BTRIEVE DESCRIPTION FILE
  933.             
  934.             
  935.             record=512 variable=y key=8 page=2048
  936.             
  937.             position=1 length=10 duplicates=n modifiable=y
  938.             type=zstring alternate=n null=n segment=n
  939.             
  940.             position=12 length=40 duplicates=y modifiable=y
  941.             type=zstring alternate=n null=n segment=n
  942.             
  943.             position=115 length=2 duplicates=y modifiable=y
  944.             type=zstring alternate=n null=n segment=n
  945.             
  946.             position=118 length=10 duplicates=y modifiable=y
  947.             type=zstring alternate=n null=n segment=n
  948.             
  949.             position=315 length=10 duplicates=y modifiable=y
  950.             type=zstring alternate=n null=n segment=n
  951.             
  952.             position=326 length=10 duplicates=y modifiable=y
  953.             type=zstring alternate=n null=n segment=n
  954.             
  955.             position=348 length=10 duplicates=y modifiable=y
  956.             type=zstring alternate=n null=n segment=n
  957.             
  958.             position=359 length=20 duplicates=y modifiable=y
  959.             type=zstring alternate=n null=n segment=n
  960.             
  961.  
  962.  
  963.  
  964.  
  965.  
  966.  
  967.  
  968.  
  969.  
  970.  
  971.  
  972.  
  973.  
  974.  
  975.  
  976.  
  977.  
  978.  
  979.  
  980.  
  981.  
  982.  
  983.  
  984.  
  985.  
  986.  
  987.  
  988.                                     Page 12
  989.  
  990.  
  991.  
  992.  
  993.  
  994.  
  995.  
  996.  
  997.             
  998.             RUNNING THE HYBRID BTRIEVE BROWSER
  999.             
  1000.             
  1001.             In order to run the Hybrid Btrieve Browser, you must first
  1002.             run Btrieve with any switches needed to open the files that
  1003.             are defined in the description file. After Btrieve is loaded
  1004.             just run HBB.EXE. The program will load into memory and
  1005.             display a small window indicating it is loaded and showing
  1006.             the hot key combination (ALT + LEFTSHIFT + R) needed to pop
  1007.             it up. Then, from DOS or from within a text display program,
  1008.             you can use the hot key to pop up HBB.
  1009.             
  1010.             
  1011.             HBB Option Selections
  1012.             ---------------------
  1013.             
  1014.             View   - Type "V" for View and a window will come up showing
  1015.                      the different views that you can select. A maximum
  1016.                      of five views will display in the window. If there
  1017.                      are more than five views you can use the arrow keys
  1018.                      to scroll to the desired view. If an error occurs
  1019.                      when trying to open a Btrieve file, the last view
  1020.                      will be redisplayed.
  1021.             
  1022.             Search - Type "S" for Search and a window will come up
  1023.                      prompting you for a value (index key) for which to
  1024.                      search. Before the search begins, the value you
  1025.                      type in will be converted into the proper format
  1026.                      (Btrieve Extended Key Type). The index key type is
  1027.                      define in the description file. A "greater than"
  1028.                      search will be performed. The first record found
  1029.                      with a key greater than or equal to the search
  1030.                      field will be displayed as the highlighted browse
  1031.                      record. If End Of File is encountered, then the
  1032.                      last record in the file will be highlighted.
  1033.             
  1034.             Paste  - Type "P" or ENTER to paste the predefined field
  1035.                      into the keyboard buffer. A carriage return is
  1036.                      appended to the field to reduce the number of
  1037.                      keystrokes needed for data entry. The paste field
  1038.                      number is defined in the description file.
  1039.             
  1040.             Unload - Type "U" to unload the Hybrid Btrieve Browser from
  1041.                      memory.
  1042.             
  1043.             About  - Type "A" to display a window describing version
  1044.                      and copyright information.
  1045.             
  1046.             Help   - Type "H" to display a window containing the
  1047.                      navigation and selection keys that can be used in
  1048.                      the HBB main display. You can scroll this screen
  1049.                      using the arrow or page keys.
  1050.             
  1051.  
  1052.  
  1053.  
  1054.                                     Page 13
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.  
  1061.  
  1062.  
  1063.             Exit   - Type "E" or ESCAPE to close the Hybrid Btrieve
  1064.                      Browser window and return control back to DOS or to
  1065.                      the previously running program.
  1066.             
  1067.             
  1068.             
  1069.             Browse Window Navigation Keys
  1070.             -----------------------------
  1071.             
  1072.             
  1073.             Escape - is used to leave all windows.
  1074.             
  1075.             Arrow Up - scrolls highlight bar up one line.
  1076.             
  1077.             Arrow Down - scrolls highlight bar down one line.
  1078.             
  1079.             Arrow Left - scrolls screen one character to the left.
  1080.             
  1081.             Arrow Right - scrolls screen one character to the right.
  1082.             
  1083.             Page Up - scrolls records up one page.
  1084.             
  1085.             Page Down - scrolls records down one page.
  1086.             
  1087.             Home - moves highlight bar to top of the screen.
  1088.             
  1089.             End  - moves highlight bar to bottom of the screen.
  1090.             
  1091.             Control + Home - displays screen starting from first record.
  1092.             
  1093.             Control + End - displays screen ending with the last record.
  1094.             
  1095.             Shift + Arrow Left  - scrolls 10 characters to the left.
  1096.             
  1097.             Shift + Arrow Right   - scrolls 10 characters to the right.
  1098.             
  1099.             Control + Arrow Left  - displays left most part of screen.
  1100.             
  1101.             Control + Arrow Right - displays right most part of screen.
  1102.             
  1103.  
  1104.  
  1105.  
  1106.  
  1107.  
  1108.  
  1109.  
  1110.  
  1111.  
  1112.  
  1113.  
  1114.  
  1115.  
  1116.  
  1117.  
  1118.  
  1119.  
  1120.                                     Page 14
  1121.  
  1122.  
  1123.  
  1124.  
  1125.  
  1126.  
  1127.  
  1128.  
  1129.             
  1130.             COMMAND LINE SWITCHES
  1131.             
  1132.             
  1133.             The Hybrid Btrieve Browser has one command line switch:
  1134.             
  1135.             HBB /U
  1136.             
  1137.             This will unload the HBB.EXE file without having to pop it
  1138.             up and type "U" to unload.
  1139.             
  1140.  
  1141.  
  1142.  
  1143.  
  1144.  
  1145.  
  1146.  
  1147.  
  1148.  
  1149.  
  1150.  
  1151.  
  1152.  
  1153.  
  1154.  
  1155.  
  1156.  
  1157.  
  1158.  
  1159.  
  1160.  
  1161.  
  1162.  
  1163.  
  1164.  
  1165.  
  1166.  
  1167.  
  1168.  
  1169.  
  1170.  
  1171.  
  1172.  
  1173.  
  1174.  
  1175.  
  1176.  
  1177.  
  1178.  
  1179.  
  1180.  
  1181.  
  1182.  
  1183.  
  1184.  
  1185.  
  1186.                                     Page 15
  1187.  
  1188.  
  1189.  
  1190.  
  1191.  
  1192.  
  1193.  
  1194.  
  1195.             
  1196.             FUTURE VERSIONS
  1197.             
  1198.             
  1199.             While writing this documentation I have accumulated some
  1200.             thoughts on what features the next version of this product
  1201.             might include. If you have a preference for any of these
  1202.             features, or have some other suggestions please drop me a
  1203.             note on compuserve. My number is 75140,3705.
  1204.             
  1205.             The features included in the next version will depend
  1206.             greatly on the response I receive to this first version. I
  1207.             would appreciate any comments or suggestions that you might
  1208.             have regarding this product.
  1209.             
  1210.             
  1211.             Below is a list of enhancements being considered:
  1212.             
  1213.             Store the view information in a Btrieve file instead of an
  1214.             ASCII file, thus reducing memory requirements. Introduce a
  1215.             new program to maintain this Btrieve view file. This would
  1216.             include conversion of existing ASCII view files, Adding,
  1217.             Changing, Deleting and Querying view information.
  1218.             
  1219.             Swap HBB.EXE to extended/expanded memory or to disk when not
  1220.             in use.
  1221.             
  1222.             Expand on-line help to display an index of help topics
  1223.             instead of just the one help screen.
  1224.             
  1225.             Expand the displayable field types to include integers,
  1226.             longs, floats, and perhaps user defined formats/masks for
  1227.             strings and numbers.
  1228.             
  1229.             Provide command line switches for default view and a user
  1230.             specified description file name. This would allow you to
  1231.             have different description files for different users,
  1232.             without putting the files in different directories or paths.
  1233.             
  1234.             Display more information about the current view, for example
  1235.             view name, data file name, path, key number, key field name,
  1236.             paste field name, free memory, free disk space, number of
  1237.             records in the current view file, and Btrieve version.
  1238.             
  1239.             Allow a view to be used for text display purposes. This
  1240.             would mean you would not see a highlight bar. You would not
  1241.             need to paste anything or search the key field. This would
  1242.             make HBB.EXE better for displaying help or reference
  1243.             information.
  1244.             
  1245.             Provide the ability to search all the display fields for a
  1246.             string value, not just the index field. If a record is found
  1247.             with the string value, then bring it up on the screen as the
  1248.  
  1249.  
  1250.  
  1251.  
  1252.                                     Page 16
  1253.  
  1254.  
  1255.  
  1256.  
  1257.  
  1258.  
  1259.  
  1260.  
  1261.             highlighted record. Also include the ability to continue or
  1262.             abort the search.
  1263.             
  1264.             Save the browse screen information so the next time the view
  1265.             is displayed it will appear the same as the last time it was
  1266.             viewed.
  1267.             
  1268.             User specified hot keys.
  1269.             
  1270.             
  1271.             
  1272.             Remember that continued maintenance and improvement of this
  1273.             product depends on you. If you like Hybrid Btrieve Browser,
  1274.             please register by sending $29.95 to the address below, plus
  1275.             $3.00 for shipping and handling. ($5 for Canada and $8 for
  1276.             airmail outside North America).
  1277.             
  1278.             The address is:
  1279.             
  1280.             Michael S. Graham
  1281.             3 Algonquin Ave.
  1282.             Rockaway, NJ 07866
  1283.             
  1284.  
  1285.  
  1286.  
  1287.  
  1288.  
  1289.  
  1290.  
  1291.  
  1292.  
  1293.  
  1294.  
  1295.  
  1296.  
  1297.  
  1298.  
  1299.  
  1300.  
  1301.  
  1302.  
  1303.  
  1304.  
  1305.  
  1306.  
  1307.  
  1308.  
  1309.  
  1310.  
  1311.  
  1312.  
  1313.  
  1314.  
  1315.  
  1316.  
  1317.  
  1318.                                     Page 17
  1319.  
  1320.  
  1321.  
  1322.  
  1323.  
  1324.  
  1325.  
  1326.  
  1327.             
  1328.             ERROR MESSAGES
  1329.             
  1330.             
  1331.             Most error messages that will be generated by the Hybrid
  1332.             Btrieve Browser will result from an invalid description file
  1333.             or a Btrieve error. If you get an error reading the
  1334.             description file you should check your HBB.DSC file very
  1335.             carefully for mistakes.
  1336.             
  1337.             
  1338.             Some Common Description File Errors
  1339.             -----------------------------------
  1340.             
  1341.             The value you enter for the # of views is greater than the
  1342.             actual number of views defined.
  1343.             
  1344.             The value you enter for the view # of fields is greater than
  1345.             the actual number of fields defined.
  1346.             
  1347.             One of the values is not within the allowed range, For
  1348.             example, the VIEW # OF COLUMNS minimum is 26 and maximum is
  1349.             70. If you enter 20 or 76 for this value you will get an
  1350.             error. You can find the value ranges in the section THE
  1351.             DESCRIPTION FILE.
  1352.             
  1353.             
  1354.             Some Common Btrieve Errors
  1355.             --------------------------
  1356.             
  1357.             Btrieve error number 20 means Btrieve is not loaded. Load
  1358.             Btrieve then run HBB.EXE again.
  1359.             
  1360.             Btrieve error number 12 means the file you defined in the
  1361.             description file can not be opened. This could be the file
  1362.             does not exist or if you are on a network, you may have
  1363.             logged into a user area that does not have access to that
  1364.             file.
  1365.             
  1366.             For most other Btrieve error codes returned by HBB you
  1367.             should refer to your Btrieve manual.
  1368.             
  1369.             When in doubt you can unload Btrieve, then load it again
  1370.             (make sure you use the correct /M and /P command line
  1371.             switches) and then load HBB.EXE again to see if the error
  1372.             occurs again.
  1373.             
  1374.  
  1375.  
  1376.  
  1377.  
  1378.  
  1379.  
  1380.  
  1381.  
  1382.  
  1383.  
  1384.                                     Page 18
  1385.  
  1386.  
  1387.  
  1388.  
  1389.  
  1390.  
  1391.  
  1392.  
  1393.             
  1394.             TRADEMARKS
  1395.             
  1396.             
  1397.             Btrieve is a registered trademark of Softcraft, Inc, A
  1398.             Novell Company.
  1399.             
  1400.             IBM is a registered trademark of International Business
  1401.             Machines Corporation.
  1402.             
  1403.             Microsoft is a registered trademark of Microsoft
  1404.             Corporation.
  1405.             
  1406.             NetWare and Novell are registered trademarks of Novell, Inc.
  1407.             
  1408.             Borland C++ is a trademark of Borland International , Inc.
  1409.             
  1410.             QuickBASIC is a trademark of Microsoft Corporation.
  1411.             
  1412.             
  1413.             ACKNOWLEDGEMENTS
  1414.             
  1415.             This product was created using TCXL, Copyright Innovative
  1416.             Data Concepts 1990-1991.
  1417.             
  1418.             
  1419.  
  1420.  
  1421.  
  1422.  
  1423.  
  1424.  
  1425.  
  1426.  
  1427.  
  1428.  
  1429.  
  1430.  
  1431.  
  1432.  
  1433.  
  1434.  
  1435.  
  1436.  
  1437.  
  1438.  
  1439.  
  1440.  
  1441.  
  1442.  
  1443.  
  1444.  
  1445.  
  1446.  
  1447.  
  1448.  
  1449.  
  1450.                                     Page 19
  1451.  
  1452.  
  1453.